Sketch in Magellan format notes. (Still more to do...)
authorrobertl <robertl>
Wed, 7 Jun 2006 20:13:51 +0000 (20:13 +0000)
committerrobertl <robertl>
Wed, 7 Jun 2006 20:13:51 +0000 (20:13 +0000)
xmldoc/formats/magellan.xml
xmldoc/formats/magellan1.xml
xmldoc/formats/magellanx.xml
xmldoc/formats/options/magellan-maxcmts.xml
xmldoc/formats/options/magellan1-baud.xml
xmldoc/formats/options/magellan1-deficon.xml
xmldoc/formats/options/magellan1-maxcmts.xml
xmldoc/formats/options/magellan1-noack.xml
xmldoc/formats/options/magellan1-nukewpt.xml
xmldoc/formats/options/magellanx-maxcmts.xml

index ef850831f822f6c25123712211060b5f81260f17..bc671532edba8c2023f2945772a6e01ba6f419d7 100644 (file)
@@ -1,14 +1,37 @@
-
-      
-      
-      <para>Waypoint serial upload and download works reliably to the
-315, 330, Meridian, and SportTrak family.  I expect it to work on any
-modern Magellan unit.</para>
-      <para> As of 08/30/02, GPSBabel can also read and write the
-files that can be stuck on the SD memory cards with the Meridian
-models.  Simply specify a file instead of a serial port.</para>
-      <para> Communication errors are handled robustly and
-verification of data is enabled.</para>
-      <para> Additional suboptions: <parameter moreinfo="none">baud:</parameter> may be 1200, 2400, 4800, 9600,
-19200, but must match receiver.</para>
-    
+<para>GPSBabel supports the following Magellan receivers:
+<simplelist columns="2">
+       <member>310</member>
+       <member>315</member>
+       <member>Map330</member>
+       <member>SporTrak Map Color</member>
+       <member>SporTrak Map</member>
+       <member>SporTrak Map Pro</member>
+       <member>SporTrak Map Topo</member>
+       <member>Meridian (green or yellow)</member>
+       <member>Meridian Gold</member>
+       <member>Meridian Platinum</member>
+       <member>Meridian Color</member>
+       <member>Explorist 100 (with aftermarket cable)</member>
+       <member>Explorist 200 (with aftermarket cable)</member>
+       <member>Explorist 300 (with aftermarket cable)</member>
+       <member>Explorist 210</member>
+       <member>Explorist 300</member>
+       <member>Explorist 400</member>
+       <member>Explorist 500</member>
+       <member>Explorist 600</member>
+       <member>Explorist XL</member>
+</simplelist>
+</para>
+     
+<para>
+       This format is used for both the serial protocol used on the
+       devices with serial ports such as Map330 and Meridian and for
+       the files stored either in either the unit's internal memory 
+       (Explorist 210, 400, 500, 600, XL) or on removable memory.
+</para> 
+<para>
+       If you specify a serial port for the file (.e.g. "COM1", "/dev/ttyS0")
+       to be read or written, GPSBabel will use serial protocol.   Specifying
+       a file, either on local filesystem or on a mounted flash card reader,
+       will results in the file-based format being used.
+</para>
index ef850831f822f6c25123712211060b5f81260f17..2ee5fbf239b28c865564aeb327168c68f22297fc 100644 (file)
@@ -1,14 +1,40 @@
-
-      
-      
-      <para>Waypoint serial upload and download works reliably to the
-315, 330, Meridian, and SportTrak family.  I expect it to work on any
-modern Magellan unit.</para>
-      <para> As of 08/30/02, GPSBabel can also read and write the
-files that can be stuck on the SD memory cards with the Meridian
-models.  Simply specify a file instead of a serial port.</para>
-      <para> Communication errors are handled robustly and
-verification of data is enabled.</para>
-      <para> Additional suboptions: <parameter moreinfo="none">baud:</parameter> may be 1200, 2400, 4800, 9600,
-19200, but must match receiver.</para>
-    
+<para>GPSBabel supports the following Magellan receivers:
+<simplelist columns="2">
+       <member>310</member>
+       <member>315</member>
+       <member>Map330</member>
+       <member>SporTrak Map Color</member>
+       <member>SporTrak Map</member>
+       <member>SporTrak Map Pro</member>
+       <member>SporTrak Map Topo</member>
+       <member>Meridian (green or yellow)</member>
+       <member>Meridian Gold</member>
+       <member>Meridian Platinum</member>
+       <member>Meridian Color</member>
+       <member>Explorist 100 (with aftermarket cable)</member>
+       <member>Explorist 200 (with aftermarket cable)</member>
+       <member>Explorist 300 (with aftermarket cable)</member>
+       <member>Explorist 210</member>
+       <member>Explorist 300</member>
+       <member>Explorist 400</member>
+       <member>Explorist 500</member>
+       <member>Explorist 600</member>
+       <member>Explorist XL</member>
+</simplelist>
+</para>
+<para>
+The RoadMate family of products is not supported.
+</para>
+     
+<para>
+       This format is used for both the serial protocol used on the
+       devices with serial ports such as Map330 and Meridian and for
+       the files stored either in either the unit's internal memory 
+       (Explorist 210, 400, 500, 600, XL) or on removable memory.
+</para> 
+<para>
+       If you specify a serial port for the file (.e.g. "COM1", "/dev/ttyS0")
+       to be read or written, GPSBabel will use serial protocol.   Specifying
+       a file, either on local filesystem or on a mounted flash card reader,
+       will results in the file-based format being used.
+</para>
index 707df3b32458881b053eecab47a832de03871e26..be4fa14a9387e2dc4380e2234e53c29b96c082bc 100644 (file)
@@ -1,9 +1,14 @@
-
-      
-      
-      <para>The SD card format used by the Magellan Explorist 400,
-500, and 600.  It's identical to the Magellan SD format used by
-Meridian, but allows longer waypoint names.</para>
-      <para> You should name any file created with this format with a
-".upt" extension so the firmware can read it.</para>
+<para>
+       This is the SD card format used by the Magellan Explorist 400,
+       500, 600, and XL and internally on those devices plus the 
+       Explorist 210.  Waypoints are identical to the Magellan SD format 
+       used by Meridian, but allows longer waypoint names.  Routes are 
+       subtly different.
+</para>
+<para>         
+       You should name any file containing waypoints created with 
+       this format with a ".upt" extension so the firmware can read it.
+       Similarly, routes should be named ".rte" and tracks should be
+       named ".log".
+</para>
     
index 8b137891791fe96927ad78e64b0aad7bded08bdc..1c46dd1088eedb0cf2c0b15c3117e4fd9134e358 100644 (file)
@@ -1 +1,13 @@
-
+<para>
+The maxcmts option allows you to specify the number comments that will
+be sent to the unit.
+</para>
+<para>
+Magellan receivers allow a maximum of 200 waypoint comments.  Unfortunately,
+DirectRoute uses waypoint comments to provide next turn directions for
+navigation pop-ups and that comes from that pool of 200 comments.  It
+is therefore sometimes convenient to limit the number of waypoint 
+comments written to the receiver.   For example, a geocacher might want
+to upload 400 waypoints, but only 190 with comments so that DirectRoute
+could provide driving directions for the next ten turns.
+</para>
index 8b137891791fe96927ad78e64b0aad7bded08bdc..0682faa0a9b57ed5146e037247897fcc50974dce 100644 (file)
@@ -1 +1,8 @@
-
+<para>
+  This option causes GPSBabel to use the given baud rate for serial
+  communications.  It must match the given baud rate on the receiver.  The 
+  default value matches the default on the receiver, 4800.
+</para>
+<para>
+  Valid options are 1200, 2400, 4800, 9600, 19200, 57600, and 115200.
+</para>
index 8b137891791fe96927ad78e64b0aad7bded08bdc..f1d272b059442051be138e5537944881c955a3be 100644 (file)
@@ -1 +1,15 @@
-
+<para>
+This option specifies the icon or waypoint type to write for each waypoint on
+output.
+</para>
+<para>
+If this option is specified, its value will be used for all waypoints, not
+just those that do not already have descriptions.  That is, this option
+overrides any icon description that might be in the input file.
+</para>
+<!--
+Eventually link to a table of valid icons...
+-->
+<para>
+This option has no effect on input.
+</para>
index 8b137891791fe96927ad78e64b0aad7bded08bdc..1c46dd1088eedb0cf2c0b15c3117e4fd9134e358 100644 (file)
@@ -1 +1,13 @@
-
+<para>
+The maxcmts option allows you to specify the number comments that will
+be sent to the unit.
+</para>
+<para>
+Magellan receivers allow a maximum of 200 waypoint comments.  Unfortunately,
+DirectRoute uses waypoint comments to provide next turn directions for
+navigation pop-ups and that comes from that pool of 200 comments.  It
+is therefore sometimes convenient to limit the number of waypoint 
+comments written to the receiver.   For example, a geocacher might want
+to upload 400 waypoints, but only 190 with comments so that DirectRoute
+could provide driving directions for the next ten turns.
+</para>
index 8b137891791fe96927ad78e64b0aad7bded08bdc..f8d84cab2ae71dc3ddcbbd42a4e44026834a7987 100644 (file)
@@ -1 +1,17 @@
-
+<para>
+Magellan's protocol specification strongly encourages the use of software
+acknowledgements on every packets.   This is a simple "this is what I think
+I heard.  If you agree that I heard it correctly, let's go to the next packet"
+handshake that is used to ensure the integrity of the data transfer.
+</para>
+<para>
+Certain firmware versions have problems handling this which makes transfers
+unnecessarily slow.  Transfers on all units at high serial speeds  are also
+severely restricted by this process. 
+</para>
+<para>
+In controlled environments (good cables, low electrical noise, receiving
+from the unit, not doing donuts with the unit set to "track up" at a 150
+mile scale with 500 waypoints on the screen) it is sometimes useful to 
+release that safety belt by using the "noack" suboption.
+</para>
index 8b137891791fe96927ad78e64b0aad7bded08bdc..5ca8916115c1f1e6ab6557d673fe20374192ce6d 100644 (file)
@@ -1 +1,10 @@
-
+<para>
+This option erases all waypoints in the receiver before doing a transfer.
+</para>
+<para>
+This is a convenient option to use in automated processes where you want
+to ensure the units starts with a clean state before sending waypoints to
+it.   Using this option on transmit is a better idea than doing it on 
+receive since the latter would erase all the waypoints before asking the
+unit to send all the waypoints.
+</para>
index 8b137891791fe96927ad78e64b0aad7bded08bdc..1c46dd1088eedb0cf2c0b15c3117e4fd9134e358 100644 (file)
@@ -1 +1,13 @@
-
+<para>
+The maxcmts option allows you to specify the number comments that will
+be sent to the unit.
+</para>
+<para>
+Magellan receivers allow a maximum of 200 waypoint comments.  Unfortunately,
+DirectRoute uses waypoint comments to provide next turn directions for
+navigation pop-ups and that comes from that pool of 200 comments.  It
+is therefore sometimes convenient to limit the number of waypoint 
+comments written to the receiver.   For example, a geocacher might want
+to upload 400 waypoints, but only 190 with comments so that DirectRoute
+could provide driving directions for the next ten turns.
+</para>